MoveAxisContinuousAbsolute
命令控制的运动至指定的绝对位置,并以指定的速度结束。
语法
KsCommandStatus MoveAxisContinuousAbsolute(
int Index,
double Position,
double Velocity,
double EndVelocity,
double Acceleration,
double Deceleration,
double Jerk,
McDirection Direction,
McBufferMode BufferMode
);
参数
Index [in]:轴索引。索引以零为起点;别名将影响此参数。
Position [in]:运动的命令位置,[秒] (正或负值)。
Velocity [in]:最大速度值,[单位/秒]。
EndVelocity [in]:最终速度值,为带正负号的值,[秒]。
Acceleration [in]:加速度值,单位由 McProfileType 类型决定,为 [单位/秒2] 或 [秒]。
Deceleration [in]:减速度值,单位由 McProfileType 类型决定,为 [单位/秒2] 或 [秒]。
Jerk [in]:加加速度值,单位由 McProfileType 类型决定,为 [单位/秒3] 或 [秒]。
Direction [in]:轴移动的方向,请见 McDirection 类型。
BufferMode [in]:定义如何融合两功能的速度,请见 McBufferMode 类型。
回传值
返回 KsCommandStatus 结构。
备注
- 若到达命令位置且没有新的运动命令放入缓冲区,则轴继续以指定的 EndVelocity 运行。
- 若 EndVelocity 小于 Velocity,轴将在到达命令位置后使用 EndVelocity 运行; 若 EndVelocity 大于 Velocity,轴将使用 Velocity 运行。
- 如果在这些函式上使用了 BufferMode,则此函式可以由 MoveAxisAbsolute 和 MoveAxisVelocity 的组合替换。
- 当模数轴启用时,模数值会套用至 Position 参数,轴将依据所设的 Direction 移动。
例如,若模数值为 360,当 Direction 设定为:- mcShortestWay / mcCurrentDirection:轴会采用最短距离到达目标。若距离相同,轴将以正方向移动至目标。例如,若目前位置为 0,目标位置为 340,轴将移动 -20 到达目标位置,最终位置将为 340。
- mcPositiveDirection:轴以正方向移动至目标。例如,若目前位置为 0,目标位置为 -20,轴将移动 340 到达目标位置。
- mcNegativeDirection:轴以负方向移动至目标。例如,若目前位置为 0,目标位置为 20,轴将移动 -340 到达目标位置,最终位置将为 20。
范例
N/A
使用需求
RT | Win32 | |
---|---|---|
最低支援版本 | 4.0 | 4.0 |
标头档 | ksmotion.h | ksmotion.h |
程式库 | KsApi_Rtss.lib | KsApi.lib |
参见